<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ page import="com.google.appengine.api.users.User" %>
<%@ page import="com.google.appengine.api.users.UserService" %>
<%@ page import="com.google.appengine.api.users.UserServiceFactory" %>
<%@ page import="java.util.List" %>
<%@ page import="howl.Twitter.EnableTwitter" %>
<%@ page import="javax.jdo.Query" %>
<%@ page import="howl.Twitter.TwitterProvider" %>
<%@ page import="twitter4j.Twitter" %>
<%@ page import="twitter4j.http.RequestToken" %>
<%@ page import="java.util.Date" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Strict/EN"> 
<html> 
  <head> 
	<%@ include file="loggedIn.jsp" %>
	<meta http-equiv="content-type" content="text/html; charset=UTF-8"> 
	<link rel="stylesheet" type="text/css" href="/style.css" /> 
	<title>Howl: a web service for the Internet of Things</title> 
  </head> 
 
  <body> 

  <div id="commands">
    <a class="command" href="/Auth/QuickEntry.jsp">Run commmand</a> 
    <a class="command" href="<%= userService.createLogoutURL("/Welcome.jsp") %>">Sign out</a> 
  </div>  <!-- end commands -->

  <div id="page">

	<div id="TopBanner"> 
	  <p>Howl: a web service for the Internet of Things</p>
	</div> <!-- end TopBanner --> 

	<div id="menu"> 
	  <p>
		<%@ include file="menu.jsp" %>
		<!-- <a class="menu" href="index.jsp">Home</a>  -->
		<!-- <a class="menu" href="CreateFeed.jsp">Create feed</a>  -->
		<!-- <a class="menu" href="FAQ.jsp">FAQ</a>  -->
		<!-- <a class="menu" href="About.jsp">About</a>  -->
	  <p>
	</div> <!-- end menu -->

	<div id="content">


<strong>Documentation</strong>
<div class="question">
How do I use Howl?
</div> <! -- End question -->
<div class="answer">
Howl allows for the integration of sensor data into web2.0 service. Howl integrates with<br><br>

	Twitter<br>
	Email<br>
	Your Flowing data<br>
	Pachube<br>
	Rss<br><br>

You should have accounts with any web2.0 service you which Howl to interact with.<br>
<br>
Step 1<br>
<br>
Sign up for web2.0 services<br>
<br><br>
Step 2<br><br>

Go to Howl and register for an account, checking the boxes of the services you wish<br>
Howl to intehrate with. Provide Howl access to Twitter and provide pachube API_KEY if you<br>
have selected theses services.<br>
<br><br>

Step 3<br>
<br>
Your ready to start using Howl.<br>
</div> <! -- End answer -->

<div class="question">
How to use Howl?
</div>

<div class="answer">
Read the Howl language definition.<br><br>


Step 1

Create a feed, with a command similar to; <br><br>

create [FEED NAME] [FIELD_n] [FIELD_n_UNIT] [FIELD_n+1] [FIELD_n+1_UNIT] ... <br><br>


A few things to remember when creating feeds:<br>

	Feeds are not permitted to have spaces in<br>
	Character which have significance in URLs such as '%' '&' should be avoided<br>
		on the occasions you wish to use them, use there ascii hex value e.g.<br><br>

			[white space] = %20<br>
			'%' = %26<br>
			'&' = %27<br><br>


Step 2<br><br>

Register a dataprovider (Sensing device), with a command similar to;<br><br>

regsiter [FEED NAME] [dataprovider name] [longitude] [latitude]<br><br>


Step 3<br><br>

Start submitting your data.
</div>

<div class="question">
How do I send data through twitter?
</div>
<div class="answer">
Send a direct message to UoWHowl with your Howl command in.
</div>

<div class="question">
How do I send data through email?
</div>
<div class="answer">
send an email to <your_feed_name>@uowapplication.appspot.com containing your command in the body.
</div>

<div class="question">
Howl do I use Howl's RESTful interface?
</div>
<div class="answer">
Submit data to the url:<br><br>

http://uowapplication.appspot.com/PostCommand?command={YOUR HOWL COMMAND}
</div>

<div class="question">
How do I retrieve data from Howl?
</div>
<div class="answer">
To get data in xml format:<br><br>

http://uowapplication.appspot.com/XML/[feed name].xml<br><br>

To get data in JSON format:<br><br>

http://uowapplication.appspot.com/JSON?name=[feed name]
</div>



	</div> <!-- end content -->
  </div> <!-- end page -->
  <div id="footer">
	<p>Copyright University of Wolverhampton &copy; 2009</p>
  </div> <!-- end footer -->

</body> 
</html> 
